Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add ability to publish family provider docs for provider-updoc workflow #134

Merged
merged 2 commits into from
Sep 27, 2023

Conversation

turkenf
Copy link
Contributor

@turkenf turkenf commented Sep 14, 2023

Description of your changes

This PR adds the ability to publish family provider docs for provider-updoc workflow

I have:

  • Run make reviewable test to ensure this PR is ready for review.

How has this code been tested

Manually tested on turkenf/uptest and turkenf/provider-gcp

Result of the upload docs step of the updoc workflow triggered in turkenf/provider-gcp:

Screenshot 2023-09-27 at 17 17 46

Manual publishing for provider-family-gcp v0.33.0 family provider:

Screenshot 2023-09-27 at 17 18 42

@turkenf turkenf changed the title Add ability to publish family providers for provider-updoc workflow Add ability to publish family provider docs for provider-updoc workflow Sep 27, 2023
@turkenf turkenf marked this pull request as ready for review September 27, 2023 14:20
Copy link
Contributor

@ulucinar ulucinar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @turkenf, lgtm. Left some comments for you to consider.

.github/workflows/provider-updoc.yml Outdated Show resolved Hide resolved
.github/workflows/provider-updoc.yml Outdated Show resolved Hide resolved
.github/workflows/provider-updoc.yml Show resolved Hide resolved
go run github.com/upbound/uptest/cmd/updoc@${{ env.UPTEST_VERSION }} upload --docs-dir=./docs --name=${{ env.PROVIDER_NAME }} --version=${{ env.VER_MAJOR_MINOR }} --bucket-name=bucket-marketplace-docs-production --cdn-domain=https://user-content.upbound.io
for s in $SUBPACKAGES; do
PROVIDER_PACKAGE_NAME="${{ env.PROVIDER_NAME }}-$s"
DOCS_DIR="./docs/family"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: In a future iteration, we may rename the docs/family folders in the official provider repositories as docs/config because config is the name that we use internally for referring to the family's config package. This would further allow us to compute the docs folder from which to publish the docs as follows:

DOCS_DIR="./docs/${s}"

This would also eliminate the conditionals in this block. It would also make it easy for us to publish specific docs for new resource providers (if this is needed in the future).

@turkenf turkenf merged commit 800afb9 into upbound:main Sep 27, 2023
5 checks passed
@turkenf turkenf deleted the update-provider-updoc branch October 9, 2023 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants